Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Creating and Manipulating Shape Objects

GXGetDefaultShape

You can use the GXGetDefaultShape function to obtain a reference to the default shape object for a particular shape type.

gxShape GXGetDefaultShape(gxShapeType aType);

aType

A shape type that specifies which default shape object to return.

function result

A reference to the default shape for the shape type specified by the aType parameter.

DESCRIPTION

Note that the return value of this function is a reference to the actual default shape object, not a copy of it. If you edit the shape returned by this function, you alter the actual default shape object that the system uses when creating new shape objects.

You can also alter a default shape object by using the GXSetDefaultShape function.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
illegal_type_for_shape	(debugging version)

SEE ALSO

Default shape objects are discussed in the section "Default Shapes" beginning on page 2-18.

The GXSetDefaultShape function is described in the next section.

To create a copy of a default shape object, use the GXNewShape function, described on page 2-54.